home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 February / EnigmA AMIGA RUN 15 (1997)(G.R. Edizioni)(IT)[!][issue 1997-02][PLANET CD V].iso / enigma / earcd / comm / comm1 / cnet_who.lha / who / WHO_README!.text < prev   
Text File  |  1996-12-08  |  37KB  |  814 lines
  1. ============================================================================
  2.                CNet WHO's, v2.66 from Frontiers BBS! by Dotoran
  3. ============================================================================
  4.  
  5. What Is It?
  6. ~~~~~~~~~~~
  7.     This is the WHO replacement package you've been waiting for! Especially
  8. if you're a multi-line SysOp, as these are the FIRST EVER external WHO files
  9. that EXACTLY MIMIC CNet's WHO commands in ALL ways, including HIDDEN users!
  10.  
  11.     You will find three versions of the WHO command, each with it's own list
  12. of features:
  13.  
  14. "Short Who" - The "W" Command:
  15.  ~~~~~~~~~         ~
  16.     - Port Number (Scans ALL Loaded Ports. Will only display IDLE ports if
  17.                    you have this enabled through CNet's CONFIG program!)
  18.     - User's Handle
  19.     - Where the User IS in your System!
  20.     - Conference Control Flag (+) Supported 100%. (This means that users on
  21.       other ports who try to Hide or Muffle a Conf. Controller will appear
  22.       to do so on THEIR screens, but will FAIL to do so on the Controller's
  23.       WHO screen, just like CNET!)
  24.     - Hiding "h", and Muffling "m" fully supported.
  25.     - Attempted Hiding "H", and Attempted Muffling "M" also supported!
  26.       (This is what a Conference Controller will see on their WHO screens
  27.        of user's who are trying to Hide or Muffle them!)
  28.     - SuperUser Flag "S" now shown as well. Users with the "SuperUser" flag
  29.       will have added abilities on the "Internet" side of things, once CNet
  30.       has these features more solidly in place. (Presently, the flag is NOT
  31.       being used yet).
  32.     - Idle Ports now have the ability to show how LONG they've been Idle,
  33.       provided you have "Show Idle Ports" set in CONFIG!
  34.     - Occupied Ports that have been IDLE for LONGER than 5 minutes now tell
  35.       you this, so that you can get an idea as to whether or not the user
  36.       on the port is REALLY there or not!
  37.     - Fully colorized, with two separate HELP menus for beginning users!
  38.  
  39.  
  40. "Normal Who" - The "WH" Command:
  41.  ~~~~~~~~~~         ~~
  42.     - Contains everything the "Short" format does, PLUS:
  43.     - Logon Time.
  44.     - Current CPS Rate (Baud/100).
  45.     - City, State, and Country User Hails From.
  46.     - User's Short, Internal CNet WHO Banner!
  47.     - Idle Ports can now use an optional IDLE Banner, a line of up to 54
  48.       characters that could possibly tell such info as phone numbers, baud
  49.       rates, times, etc. If an Idle Banner is NOT created, the user will be
  50.       shown the regular "<No One>  0  Idle" line instead, unless a DEFAULT
  51.       Idle Banner has also been created.
  52.  
  53.  
  54. "Long Who" - The "WHO" Command:
  55.  ~~~~~~~~         ~~~
  56.     - Contains all "Short" and "Normal" information, PLUS:
  57.     - Last Call Date.
  58.     - Gender of User (Male or Female)[Color Coded Blue or Red]
  59.     - Time Used Online TODAY (in Minutes)
  60.     - The User's 3-Line "Glimpse" file.
  61.     - A History Flag "*" Telling which Users Have History Files, which are
  62.       text files of up to 20-Lines!
  63.  
  64. ----------------------------------------------------------------------------
  65.     Of course, all appear in the FRONTIERS BBS Color Scheme, but can easily
  66. be changed by using the included CONFIG file.
  67.  
  68.     All three versions of the command may also take numeric arguments, which
  69. act just like CNet's built-in versions. These numbers represent the PORTS in
  70. which you wish to scan, like these examples illustrate:
  71.  
  72.     W 0-2             : Short WHO for Ports 0 thru 2.
  73.     WH 1 4 10         : Normal WHO for Ports 1, 4, and 10.
  74.     WHO 0-2,5.9 12-   : Long WHO for Ports 0 thru 2, 5, 9, and all Ports
  75.                         from 12 thru your Highest Loaded Port.
  76.  
  77.     Note that ALL forms of arguments are allowed:  2  0,3  1-4,  2.5.8, etc.
  78.  
  79.     Provided the user has the "Conference Control" flag set in their account,
  80. they may also specify the <C>onfig argument to load the CONFIG file:
  81.  
  82.     W C     : Load CONFIG, ready to Edit Short Who data.
  83.     WH C    : Load CONFIG, ready to Edit Normal Who data.
  84.     WHO C   : Load CONFIG, ready to Edit Long Who Data.
  85.               This version also allows for ALL Versions to be Created.
  86.  
  87.     You can type as much of the word CONFIG as you wish, but only the first
  88. letter will be looked at, so the following would also load the CONFIG:
  89.  
  90.     W CONFIG
  91.     WH CON
  92.     WHO C
  93.  
  94.     Also, when using the "Long" Who version, there are four more arguments
  95. that can be used to SKIP the WHO Listing and immediately enter one of the
  96. Long Who prompt commands. Again, you may type as MUCH of the keyword as you
  97. wish, but only the first letter is required:
  98.  
  99.     WHO B   (or WHO BANNERS, etc.) to edit/pick a Short Who Banner!
  100.     WHO G   (or WHO GLIMPSE, etc.) to edit their Glimpse File!
  101.     WHO H   (or WHO HISTORY, etc.) to edit their History File!
  102.     WHO V   (or WHO VIEW, etc.)    to edit their History File also!
  103.  
  104.     In addition, these NEW arguments have been added into v2.1c. Two are for
  105. Conference Controllers ONLY, and the other two are for ALL users:
  106.  
  107.     Conference Controllers ONLY:
  108.   ================================
  109.  
  110.     WHO I   (or WHO IDLES, etc.)   to ReLoad your Idle Who Banners!
  111.  
  112.     WHO E   (or WHO EDIT, etc.)    to Modify your Idle Who Banners!
  113.  
  114.         - The editor is entered, giving you 102 lines. This is to allow for
  115.           100 lines of regular ports, 1 line for a default banner, and 1
  116.           line for the Total Banners on file.
  117.  
  118.     Available to ALL Your Users:
  119.   ================================
  120.  
  121.     WHO P   (or WHO PORT, etc.)    to display CURRENT PORT's Idle Banner.
  122.  
  123.         - This comes in handy when a user wishes to know which phone number
  124.           they happened to call in on, etc.
  125.  
  126.     WHO Q   (or WHO QUICK, etc.)   to QUICK display the "Long" output.
  127.  
  128.         - "Quick" display will suppress the printing of Glimpses, lines of
  129.           separator characters BETWEEN each port, as well as any HELP MENUS
  130.           that may need to be printed, and finally the options prompt. What
  131.           is RETAINED is the Last Call Date, User Gender, History Flag and
  132.           Total Time Online Today, which is NOT shown in the "Normal" file.
  133.  
  134.     Lastly, all WHO's should be able to be aborted by pressing ANY key while
  135. they are displaying, without having to wait for the ENTIRE listing to be
  136. shown.
  137.  
  138.  
  139. How Do I Install It?
  140. ~~~~~~~~~~~~~~~~~~~~
  141. 1: Copy the "Who/" directory somewhere on your system, preferably somewhere
  142.    in your DOORS: assigned area. It doesn't matter WHERE you copy this Who/
  143.    directory, however make sure you leave ALL FILES TOGETHER inside of this
  144.    directory. Remember the path you placed this directory, and use it when
  145.    you see the <path> designations below.
  146.  
  147. 2: Load your BBSMENU text file, found in the CNET: path, into any text editor
  148.    and make the following changes:
  149.  
  150.         A: Locate Menu # 2, Available Everywhere Menu, and find the entry
  151.            line containing the text "WHo" and place a "2" in FRONT of this
  152.            text, so that the text now reads "2WHo" (minus the quotes).
  153.  
  154.         B: At the BOTTOM of this Menu, add the following three lines:
  155.  
  156.                 WHO    `1- | {#0<path>Who/Long}
  157.                 WHo    `1- | {#0<path>Who/Normal}
  158.                 Who    `1- | {#0<path>Who/Short}
  159.                              |
  160.                              `---> A Control-Q character.
  161.  
  162.           NOTE1: The CAPITALIZATION of the word "WHO" is VERY important in
  163.                  these three lines. The W, H, and O should ALL be UPPERCASE
  164.                  in the FIRST line, while only the W and H in the SECOND
  165.                  line, and ONLY the W in the THIRD line.
  166.  
  167.           NOTE2: Change the <path> above to the one you used in Step # 1.
  168.  
  169.         C: Since CNet's built-in WHO command looks almost IDENTICAL to MY
  170.            "Normal WHo" version, I choose to use CNet's version instead of
  171.            mine. I do this, mainly for speeds sake. To make YOUR System use
  172.            CNet's WHO for the SECOND version, change the SECOND line above,
  173.            so that it reads like this:
  174.  
  175.                 WHo    `1- | {& 2WHo}
  176.                              |
  177.                              `---> A Control-Q character.
  178.  
  179.           NOTE1: The "2WHo" text, inside the {& } command, should appear the
  180.                  EXACT same as it appears in the BBSMENU file, as you changed
  181.                  it in step "A" above. That is, only the "W" and "H" should be
  182.                  capitalized.
  183.  
  184.           NOTE2: I use a "2" in front of the internal WHo command, instead
  185.                  of one of those oddball looking ALT-Graphic characters,
  186.                  because remote users can NOT produce these characters in
  187.                  their terminal programs, so would be UNABLE to invoke the
  188.                  "old" usage of this(or any other) "set aside" commands.
  189.  
  190.         D: Starting with v2.64 of CNet Who, you can now additionally create
  191.            numerous OTHER commands by specifying an argument in the BBSMENU
  192.            line, using the LONG module, as these examples illustrate:
  193.  
  194.                 WQ, Who Quick   `1- | {#0<path>Who/Long Q}
  195.                 WB, Who Banners `1- | {#0<path>Who/Long B}
  196.                 WP, Which Phone `1- | {#0<path>Who/Long P}
  197.                 WG, Who Glimpse `1- | {#0<path>Who/Long G}
  198.                 WH, Who History `1- | {#0<path>Who/Long H}
  199.                                       |
  200.                                       `-- Control-Q characters.
  201.  
  202. 3: Locate the "Write" command in the following Menus:
  203.  
  204.             4; The new Message/File Area menu
  205.             5; Respond or Pass?
  206.             17; Mail
  207.             20; Browse
  208.  
  209.    You must change the TEXT of this command, so that it reads:
  210.  
  211.             WRite       instead of      Write
  212.              |
  213.              `---> Make this "R" UPPERCASE.
  214.  
  215.    This is a needed change, because unless you make this change, the WRITE
  216.    command will NOT function in these areas if the user types "W" to change
  217.    the description of a file, or enter the editor with the current mail
  218.    message(They'll be shown the SHORT WHO instead!)
  219.  
  220. 4: You will also want to update the following HELP files, which can be
  221.    found inside your "SysText:Help/" directory to reflect the change you
  222.    made in Step # 3:
  223.  
  224.             mail   - Goes with Menu # 4 & 5
  225.             post   - Goes with Menu # 17 & 20
  226.  
  227.     I checked the "browse" help file, but noticed the WRITE command was not
  228.     included in that file, so no changes are needed to that file. To make
  229.     the change, the line in question starts with:
  230.  
  231.             \c7W\c6rite ...etc.
  232.  
  233.     Change it, so it looks like this:
  234.  
  235.             \c7WR\c6ite ...etc.
  236.             |    |
  237.             `----`---> Remember, these are Control-Y characters!
  238.  
  239. 5: Load your BBSTEXT file into a text editor, then go to line 62 of that
  240.    file. It looks like this(in a stock 4.21 bbstext):
  241.  
  242.             \n1@ Cleared for logon\n1
  243.             |                     |
  244.             `---- Control-Y's ----'
  245.  
  246.    To the end of this line, add the following:
  247.  
  248.             {#0<path>Who/Loader}
  249.             ^
  250.             Control-Q
  251.  
  252.    This will insure that the IdlePort Banners are loaded, as well as
  253.    updating the user's multiple who banners(if allowed).
  254.  
  255. 6: Edit the "IdlePorts" text file, included inside the "Who/" directory to
  256.    contain the Idle Banners you wish to use. The format of the file is
  257.    fairly loose:
  258.  
  259.         Line 1: Should contain a number, followed by at LEAST one SPACE,
  260.                 then any other text you wish. This NUMBER is the total
  261.                 number of lines BELOW that will be read into the computer
  262.                 the FIRST time someone logs onto the bbs AFTER this mod
  263.                 has been installed.
  264.  
  265.       Line 2-?: a|b
  266.                 ||`--> Idle Banner Text.
  267.                 |`---> Pipe (Vertical Bar) [To Right of Equals Sign]
  268.                 `----> The Port Number.
  269.  
  270.                 eg: 1|Line # 1, SupraFAX 28.8 (716)/823-9892
  271.  
  272.              NOTE1: The port numbers do NOT have to come in ORDER in the
  273.                     file. Use whichever order best suits your need!
  274.  
  275.              NOTE2: Starting the line with a "D" (minus the quotes), instead
  276.                     of a Port Number will define the DEFAULT Idle Banner to
  277.                     use for any ports that may be loaded, but that do NOT
  278.                     contain a premade Idle Banner.
  279.  
  280. 7: That's it! You're Done! You can RELOAD your BBSMENU and BBSTEXT files by
  281.    using the RAMIGA-T key combination(while CNet's Control Panel is active)!
  282.  
  283. How to Enable/Disable the `SuperUser' Privilege Flag
  284. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  285.    When the `SuperUser' flag was first introduced in CNet, v4.xx, it was
  286. automatically ENABLED in every user's account.
  287.  
  288.    When fully implemented, this new flag will carry a similar function as
  289. that of the `System Operator' flag, except that this flag will determine
  290. if a user will have `root access' powers to the Internet applets which are
  291. coming to CNet Amiga in the very near future. Things like being able to
  292. finger ANYONE, being able to work with ANY file in ANY directory using the
  293. FTP commands, being automatically given "op" status in the IRC client, etc.
  294.  
  295.    So, knowing this, chances are this is NOT a flag you'll want to give to
  296. ALL of your users. Here's how you can DISABLE the new `SuperUser' flag in
  297. the user accounts on YOUR bbs's, using CNet's own EA VDE Editor:
  298.  
  299. 1. Logon to your bbs, then type the following from the main command prompt:
  300.  
  301.         EA 1-       (So that you can edit ALL accounts)
  302.  
  303. 2. You'll then be asked which access groups you wish the changes to be made
  304.    to. Enter the range of groups you wish to DISABLE the flag in, perhaps:
  305.  
  306.         0-30        (So only Group 31's would HAVE the flag enabled)
  307.  
  308. 3. You'll then be presented with the EA VDE screen, but will note that ALL
  309.    the entries are ghosted(in black). Move to the second column and select
  310.    the "Privilege flags    >>" option.
  311.  
  312. 4. Once on the "Privileges" screen, go to the LAST item in the third column,
  313.    "SuperUser      :", then press your ENTER key until you see the word "No"
  314.    appear.
  315.  
  316. 5. Move to the "Exit" option, press ENTER, then press ENTER while the "Save
  317.    changes" option is highlighted.
  318.  
  319. 6. That's It! Now just sit back and let CNet do the rest!
  320.  
  321.    How LONG the operation will take will depend on the number of accounts
  322. you have, as well as your CPU type. (On my A=2000, with over 400 accounts,
  323. it took close to a minute to complete the operation).
  324.  
  325.    Once complete, you'll notice an "S" following the Port Number in the WHO
  326. displays(both MINE and in CNet's internal version). This "S" flag Supersedes
  327. all other displays that could appear here.
  328.  
  329. What's This LONG WHO Command Menu?
  330. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  331.     Well, let's look at the command menu that appears BELOW the Long WHO's
  332. listing:
  333.  
  334.             Long Who [B]anner, [G]limpse, [V]iew History, or [QUIT]:
  335.  
  336.     From the above command menu, four commands are possible:
  337.  
  338. "[B]anner"
  339.  
  340.     - Allows the user to, then and there, edit the contents of their current
  341.       short CNet WHO Banner. (The same one available for editing via EP;14).
  342.       Their existing WHO Banner is displayed for the user as the default, so
  343.       they can make either small changes, or simply delete the whole thing
  344.       and start it over again.
  345.  
  346.     - The user is also allowed to enter MCI-Color Codes into their short
  347.       WHO Banner, using Control-Y type MCI codes.
  348.  
  349.             - NOTE: See the info below dealing with TOGGLE settings for more
  350.                     info on how you wish MCI's supported in the Who Banners.
  351.  
  352.     - They can also use the following SPECIAL Key-Strokes for editing:
  353.  
  354.             - CONTROL-X : Deletes EVERYTHING in the string gadget.
  355.             - CONTROL-B : Move Cursor to the Beginning of the string.
  356.             - CONTROL-N : Move Cursor to the eNd of the string.
  357.             - BACKSPACE : Delete character to LEFT of cursor, then move the
  358.                           cursor INTO that position.
  359.             - DELETE    : Will PULL text to the RIGHT of the cursor INTO the
  360.                           cursor, deleting characters as it goes.
  361.  
  362.     - For v2.0, this section received a bit more power, because NOW when the
  363.       user presses "B", they are taken to a NEW screen that allows them to
  364.       create MULTIPLE Short WHO Banners, up to TEN in all. They may choose
  365.       to EDIT any of them, using the techniques above, and can even swap the
  366.       "Current" Banner their using, in which case the NEW Banner would also
  367.       be permanently written to their user account(thus editable via EP;14).
  368.  
  369.     - You may disable this feature through the CONFIG file.
  370.  
  371.     - The user's Short Who Banners are stored in a file called "_Banners",
  372.       which is stored in the user's uucp mail directory inside the cnet
  373.       "mail:users/" directory.
  374.  
  375.     - For v2.1, the Loader was modified to perform a "Pick Banner" operation
  376.       whenever the user signs onto your board, PROVIDED a "Banners" file is
  377.       found for that user. This way, if they are using multiple different
  378.       banners, each call will activate a NEW banner for them, without the
  379.       user having to do it manually via "WHO B;P".
  380.  
  381. "[G]limpse"
  382.  
  383.     - The "Glimpse" files are three 78-character lines, EXCLUDING the Short
  384.       WHO Banner, that the user may create listing more info they want other
  385.       users to know about. These "Glimpse"'s are shown on the LONG version
  386.       who screen only.
  387.  
  388.     - The user is given the FULL POWER of the CNet Amiga Text Editor to enter
  389.       whatever they wish for their 3-Line "Glimpse" file. Use of ANY MCI's
  390.       the user has access to is fully supported.
  391.  
  392.     - If a user wishes to DELETE a "Glimpse" file, they should first enter
  393.       the editor with it, then DELETE it from the editor, using the .N
  394.       command, then SAVE the EMPTY editor. They will THEN be given a prompt
  395.       asking if they wish to DELETE the "Glimpse" file on disk.
  396.  
  397.     - The Glimpse file is stored as "_Glimpse" in the user's uucp directory,
  398.       in the same way the banners are.
  399.  
  400.     - If a user does not have a "_Glimpse" file created in their uucp mail
  401.       directory, then the default glimpse file will be displayed when the
  402.       LONG who version is used, however this default file is NOT stored in
  403.       the user's uucp directory, but exists as "<path>Who/_Glimpse".
  404.  
  405. "[H]istory"
  406.  
  407.     - You'll be given another command prompt when this command is used:
  408.  
  409.             [E]dit, [V]iew by Port, or [S]pecific Histories? [QUIT]:
  410.  
  411.     - If you choose to "[E]dit" your History file, any existing History will
  412.       be loaded into the CNet Editor, and you'll be given 20-Lines to enter
  413.       anything you'd like. The same editor features as the "Glimpses" are
  414.       allowed for use with "History" files.
  415.  
  416.     - If a user wishes to DELETE a "History" file, they should first enter
  417.       the editor with it, then DELETE it from the editor, using the .N
  418.       command, then SAVE the EMPTY editor. They will THEN be given a prompt
  419.       asking if they wish to DELETE the "History" file on disk.
  420.  
  421.     - Pressing "[V]iew by Port" allows the user to view the History of a
  422.       user signed onto another port. Checks are made to insure their IS a
  423.       user on that port, and that the port is LOADED.
  424.  
  425.     - If you choose "[S]pecific Histories", you'll be asked to enter either
  426.       the ID Number, Handle, or Real Name of the user to view the History of.
  427.       If an incomplete Real Name or Handle is entered, you'll be shown the
  428.       User List menu, and can then choose the proper name off the menu. It is
  429.       possible to view your OWN History file by supplying your OWN info here.
  430.  
  431.     - Pressing ENTER/RETURN, or pressing "[Q]uit" will take you back to the
  432.       initial command prompt.
  433.  
  434.     - The History file is stored as "_History" in the user's uucp directory,
  435.       in the same way the banners are.
  436.  
  437.     - If a user does not have a "_History" file created in their uucp mail
  438.       directory, then the default history file will be displayed when the
  439.       LONG who version is used, however this default file is NOT stored in
  440.       the user's uucp directory, but exists as "<path>Who/_History".
  441.  
  442. "[QUIT]"
  443.  
  444.     - Pressing ENTER/RETURN, or pressing "[Q]uit" will exit the Long Who,
  445.       and return you to the CNet Command Prompt that called WHO.
  446.  
  447. How do I use the CONFIG File?
  448. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  449.     One of the NEW features of v2.0 is the addition of an ANSI-ARexx style
  450. CONFIG program, written to mimic the VDE-type editors you may have seen and
  451. used with CNet before.
  452.  
  453.     You should enter the CONFIG program thru one of the WHO programs. Which
  454. WHO program you use to launch the CONFIG will have a bearing on which data
  455. items you will be able to edit on the various screens within the editor. For
  456. instance, things like Who Banners, Idle Port Banners, Glimpse Files, etc are
  457. not used in the SHORT form WHO program, so will appear as ghosted(black) on
  458. the CONFIG screen, and will not editable.
  459.  
  460.     As mentioned above, use one of the following three commands to load the
  461. CONFIG:
  462.             W C     : Enter CONFIG to edit Short Who data.
  463.             WH C    : Enter CONFIG to edit Normal Who data.
  464.             WHO C   : Enter CONFIG to edit Long Who data.
  465.  
  466.     You can also add the CONFIG file into your DOORS area as an Exclusive
  467. Use Only ARexx Pfile. You must specify an argument of W, WH, or WHO, so that
  468. the CONFIG will know WHICH WHO you wish to edit. Specify WHO if you wish to
  469. edit ALL of them at the same time. If the argument is NOT specified, the
  470. CONFIG file will exit, shortly after loading.
  471.  
  472.         NOTE: SysOps running a 4.xx version of CNet may have noticed that
  473.               when adding an ARexx Door, the "Arguments" field is not given
  474.               on the VDE screen, however you CAN give arguments. You simply
  475.               include a SPACE after the <path>Who/Config line, THEN include
  476.               your W, WH, or WHO argument text.
  477.  
  478.     Alright, you know HOW to load the CONFIG, now here's some info pertaining
  479. to certain things within the CONFIG that may need additional clarification:
  480.  
  481. Text String Gadgets:
  482. ~~~~~~~~~~~~~~~~~~~~
  483.     All text string gadgets may use the following SPECIAL key-strokes to aid
  484. in the entering/editing of text:
  485.  
  486.     CONTROL-X : Erase Everything.
  487.     CONTROL-B : Move to Beginning of Text.
  488.     CONTROL-N : Move to End of Text.
  489.     BACKSPACE : Delete Character to LEFT of Cursor.
  490.        DELETE : Pull Character to RIGHT of Cursor INTO the Cursor.
  491.  
  492.     In addition, each string gadget is formatted for the MAXIMIMUM allowed
  493. length that can be used in the Layout.
  494.  
  495. "BG"
  496.  ~~
  497.     Means a BackGround Color, and can be any of the following characters,
  498. which correspond to the equivalent MCI-Z Color Codes:
  499.  
  500.             0, 1, 2, 3, 4, 5, 6, and 7.
  501.  
  502. "FG"
  503.  ~~
  504.     Means a ForeGround Color, and can be any of the following characters,
  505. which correspond to the equivalent MCI-C Color Codes:
  506.  
  507.             0, 1, 2, 3, 4, 5, 6, 7, 8, 9, a, b, c, d, e, and f.
  508.  
  509. Use of BG and FG:
  510. ~~~~~~~~~~~~~~~~~
  511.     These fields use 1 character string gadgets. After pressing ENTER, you
  512. can do one of two things:
  513.  
  514.     1: Type a NEW value, which will then REPLACE the old value. Press ENTER
  515.        to confirm your choice, or use the BACKSPACE key to delete and try
  516.        again.
  517.  
  518.     2: Press ENTER again, in which case the NEXT value in sequence will be
  519.        used, so if the value WAS "a", it would become a "b". If the value
  520.        was "f", it would turn over and become a "0". A "3" would become a
  521.        "4", etc.
  522.  
  523. Use CNet "Stock" BBS
  524. Use "Frontiers"  BBS
  525. ~~~~~~~~~~~~~~~~~~~~
  526.     These two items allow you to select two built-in default settings. The
  527. "Stock" version is a rather plain looking color combination, while "Frontiers"
  528. is the familiar blue scenario that previous versions have used.
  529.  
  530. Saving Changes Made?
  531. ~~~~~~~~~~~~~~~~~~~~
  532.     The CONFIG uses a "Smart Save" feature, just like CNet's VDE Editors, so
  533. if all you do is load the CONFIG and LOOK at some values, when you select
  534. the "<< Exit" option, you will immediately exit the file, but if changes
  535. have been made, you'll get another screen asking if you'd like to SAVE the
  536. changes you've made.
  537.  
  538. ReLoad "IdlePorts"
  539. ~~~~~~~~~~~~~~~~~~
  540.     If you've made changes to the "IdlePorts" text file, you'll need to
  541. ReLoad them into memory, so that the NORMAL and LONG Who versions will
  542. reflect these changes.
  543.  
  544.     After selecting this option, a second or two will go by, then the screen
  545. should flash and you may hear a beep sound, which alerts you the process has
  546. completed.
  547.  
  548.     NOTE: Remember, as of v2.1c, you can now use "WHO I" to ReLoad the Idle
  549.           Port Banners as well.
  550.  
  551. CREATE SHORT WHO
  552. CREATE NORMAL WHO
  553. CREATE LONG WHO
  554. CREATE ALL WHO FILES
  555. ~~~~~~~~~~~~~~~~~~~~
  556.     Simply SAVING your changes is NOT all you have to do in order to BIND
  557. the changes you've done. When you're satisfied with the color/text choices
  558. you've made(use Show Example LayOuts), then you are ready to CREATE the WHO
  559. file.
  560.  
  561.     You have the option of creating a unique look for EACH of your WHO's, or
  562. you can use the "ALL WHO FILES" (only available in the LONG Who CONFIG) to
  563. use the Long Who settings to create ALL THREE versions.
  564.  
  565.     The CONFIG file actually GENERATES CUSTOM AREXX CODE containing the data
  566. you entered in the CONFIG program. This way, the WHO files execute a LOT
  567. faster than they would if they had to constantly read in a config file, set
  568. up a bunch of variables, then slap the variables into place.
  569.  
  570.     It also allows you to easily be able to EDIT any of the WHO files, if
  571. you find there are some small changes you'd like to make in ADDITION to
  572. those made by the CONFIG, however you need to follow this warning:
  573.  
  574. ***WARNING***
  575. =============
  576.  
  577.     Treat the "Short", "Normal", and "Long" text files the same way you would
  578. treat the BBSTEXT file, in that you should NOT alter the ORDER of the lines
  579. within each of these files.
  580.  
  581.     The "MakeWho" program is written to read in all the lines from each of
  582. these files, then REPLACE certain lines with those containing your CUSTOM
  583. values. ALTERING THE ORDER OR SEQUENCE of any of these files will result in
  584. CATASTROPHIC EVENTS! The "MakeWho" program may NOT be loaded externally by
  585. you through the Doors section. The CONFIG program MUST be the one that is
  586. used to call this file. (In other words, LEAVE THIS FILE ALONE!)
  587.  
  588.     Also, UNLIKE the BBSTEXT file, you should NOT alter the CONTENTS of any
  589. of the lines IF you think you'll be using the MAKEWHO program again, as any
  590. changes you make to the actual code MAY not be recreated by the MAKEWHO file,
  591. if the changed line contains an MCI-Color Code. If you note a problem in one
  592. of the lines, please alert me of the fact, so that I can take the proper
  593. steps to edit the MAKEWHO file to also correct the problem when you generate
  594. a NEW who format.
  595.  
  596.     After selecting this option, a few seconds will go by, then the screen
  597. should flash and you may hear a beep sound, which alerts you the process has
  598. completed.
  599.  
  600. Info On Toggle Switches:
  601. ~~~~~~~~~~~~~~~~~~~~~~~~
  602.     Show Idle Minutes
  603.     ~~~~~~~~~~~~~~~~~
  604.         Yes : Displays "Idle 2h 10m 7s" in the WHERE Column.
  605.         No  : Displays "Idle"           in the WHERE Column.
  606.  
  607.         NOTE: In v2.64, the format of this string changed to show the hours,
  608.               minutes, and seconds of Idle Time present. Using another new
  609.               toggle value below, you can also display DAYS of idle time.
  610.  
  611.     Show Idle Banners
  612.     ~~~~~~~~~~~~~~~~~
  613.         Yes : Displays "IdlePortB?" line, if it exists.
  614.         No  : Displays "<no one>        0"  CNet's Default.
  615.  
  616.     Multiple Banners
  617.     ~~~~~~~~~~~~~~~~
  618.         Yes : Allow User to Use/Edit Multiple Short Who Banners.
  619.         No  : Disable this feature. User will have to resort to EP;14.
  620.  
  621.     Skip Idle Ports
  622.     ~~~~~~~~~~~~~~~
  623.         Yes : Will NOT print Port Info if it's an Idle(Empty) Port.
  624.         No  : Display Idle Port Info.
  625.  
  626.     Skip Hidden Ports
  627.     ~~~~~~~~~~~~~~~~~
  628.         Yes : Will NOT print Port Info if User On that Port is HIDING.
  629.         No  : Will display this port as "appearing to be Idle".
  630.  
  631.         NOTE: When set to "No", CNet WHO uses an interesting trick to show
  632.               the number of minutes the port has been idle. The value used
  633.               here is actually the total number of minutes the CURRENT user
  634.               has been online(added to a FAKE Idle Time; discussed below).
  635.  
  636.     Allow Banner MCI's
  637.     ~~~~~~~~~~~~~~~~~~
  638.         Yes : Allow the user to use MCI commands while creating Who Banners.
  639.         No  : Do NOT allow MCI's to be input into the Who Banners.
  640.  
  641.         NOTE: If this option is set to YES, but the user does not have the
  642.               ACCESS to use MCI's, then any MCI's entered by the user will
  643.               be automatically STRIPPED from the string. Also, if the user
  644.               has MCI-1 Access, but NOT MCI-2 Access, the MCI-2 Level MCI
  645.               codes will be STRIPPED if found.
  646.  
  647.     Allow SysOp  MCI's
  648.     ~~~~~~~~~~~~~~~~~~
  649.         Yes : Allow System Operators to use SYSOP-ONLY MCI's in Banners.
  650.         No  : SYSOP-ONLY MCI commands will be STRIPPED from Who Banners.
  651.  
  652.         NOTE: A "System Operator" is a user who has this priviledge flag
  653.               set in their user accounts. Lines 4 and 5 in your BBSTEXT file
  654.               determine which commands to deem SYSOP-ONLY(Line 4) and as
  655.               Level 2 MCI's(Line 5). Any commands NOT FOUND on these two
  656.               lines are available to users with Level 1 MCI Access. These
  657.               two lines are automatically read into the CONFIG program each
  658.               time it is used, so as to insure the proper stripping is done.
  659.  
  660.     Clear Screen Before
  661.     ~~~~~~~~~~~~~~~~~~~
  662.         Yes : The Screen is CLEARED BEFORE the WHO info is shown.
  663.         No  : The Screen is NOT cleared before the info is shown.
  664.  
  665.     Use Empty Port Block
  666.     ~~~~~~~~~~~~~~~~~~~~
  667.         Yes : Use following values to SPEED up the printing.
  668.         No  : Follow normal "1x1" iteration method.
  669.  
  670.     Port to Skip FROM
  671.     ~~~~~~~~~~~~~~~~~
  672.         When this port value is reached in the loop, the loop will then
  673.         IMMEDIATELY jump to the following value.
  674.  
  675.     Port to Skip TO
  676.     ~~~~~~~~~~~~~~~
  677.         The value to RESUME scanning for Port data. For instance, with these
  678.         ports set up:  0, 1, 2, 3, 98, and 99, you'd want to specify a "3"
  679.         in the FROM field, and "98" in the TO field, so that the who isn't
  680.         having to scan: 4, 5, 6, 7, 8, 9, 10, etc. etc. etc. up to 98!
  681.  
  682.     Print IdleTime Days
  683.     ~~~~~~~~~~~~~~~~~~~
  684.         Provided you have "Show Idle Minutes" enabled, specifying YES to
  685.         this value returns an Idle Time in the format: ?d?h ?m ?s
  686.  
  687.         If set to NO, then the format used looks like: ?h ?m ?s
  688.  
  689.     Min. Fake Idle Mins.
  690.     Max. Fake Idle Mins.
  691.     ~~~~~~~~~~~~~~~~~~~~
  692.         These values were included as a means of making HIDDEN USERS appear
  693.         to be hidden MORE SO over previous versions. Because these WHO
  694.         programs have the ability to specify how LONG a port has been IDLE,
  695.         I needed a way to fake idle time on HIDDEN ports. Earlier versions
  696.         had me just snagging the number of minutes the CURRENT user was
  697.         ONLINE and using that value, however I discovered that if a user
  698.         initially logs on, then immediately uses a WHO module, they'd see
  699.         these HIDDEN ports as being Idle for 0-1 Minutes, which made it look
  700.         like these ports logged OFF as soon as this user logged ON, so that's
  701.         where these values come in. You specify a lower and upper limit to
  702.         a range of values, to which one value is randomly selected and then
  703.         ADDED TO the current user's time online. It's this SUM that is used
  704.         for the IDLE TIME for HIDDEN PORTS.
  705.  
  706. Manual Toggle Setting:
  707. ~~~~~~~~~~~~~~~~~~~~~~
  708.     It is also possible to MANUALLY set these toggles in each program by
  709. editing the given line in each version:
  710.  
  711.                           Line
  712.                          ======
  713.                     Short: 14
  714.                    Normal: 15
  715.                      Long: 24
  716.  
  717.     Use values of "1" to represent YES, and "0" to represent NO in these
  718. variables, located on the above lines. If a version doesn't contain the
  719. given variable, then that version doesn't use/support that feature.
  720.  
  721.                         Variable    Toggle It Effects
  722.                         ========    ====================
  723.                            v1       Show Idle Minutes
  724.                            v2       Show Idle Banners
  725.                            v3       Multiple Banners
  726.                            v4       Skip Idle Ports
  727.                            v5       Skip Hidden Ports
  728.                            v6       Empty Port Block
  729.                            loS      Port to Skip FROM
  730.                            hiS      Port to Skip TO (Use hiSk in LONG)
  731.                            v7       Clear Screen Before
  732.                            v8       Allow MCI's in Who Banners?
  733.                            v9       Allow SysOp's to use SysOp-MCI's?
  734.                            v10      Show IdleTime Days
  735.  
  736.     Remember, ALL VARIABLES MUST RESIDE ON THE SAME LINE, as noted in the
  737. table above. Do NOT place them on individual lines, unless you plan on NOT
  738. using the CONFIG program to CREATE new layouts.
  739.  
  740. Is That It?
  741. ~~~~~~~~~~~
  742.     So far as I can tell, YES! I believe I've covered all the bases. I still
  743. have not been able to locate that ETA line used with File Transfers. I've
  744. been able to deduce that the ETA value is calculated "on the fly" as it's
  745. needed, which makes recreating this value a tough chore, as there are many
  746. getusers involved in calculating this value, MOST of which are accessable
  747. with known getusers, however the one key value I can't seem to locate is
  748. how MANY KILOBYTES have ALREADY been DOWNLOADED(or UPLOADED). Without this
  749. value, coming up with a "ball-park" ETA value is not obtainable.
  750.  
  751.     If you notice ANY, and I mean ANY problems with this version, PLEASE get
  752. in touch with me, either on Frontiers, The Metal Shoppe, thru Fido-Net Mail
  753. to "David Weeks@1:260/121", CLink-Net Mail to "David Weeks@911:6840/2.0",
  754. or on the InterNet via "dotoran@bluemoon.net".
  755.  
  756.     There WILL be at least ONE more major release, but I can't put a date as
  757. to when you'll be seeing it, as I've got to start on it again from scratch!
  758.  
  759.     Enjoy this work! I put some serious work into it!
  760.                                                                   - Dotoran
  761.  
  762. In The Future?
  763. ~~~~~~~~~~~~~~
  764.     CNet WHO, v3.0 will be a complete rewrite, from the ground up, so that I
  765. can also include a custom DATA LAYOUT screen. What this means is you'll then
  766. be able to "pick and choose" exactly WHICH info you wish to show in each of
  767. your three WHO formats. Here's an ASCII shot of the screen layout I'm working
  768. on right now. This is still pretty sketchy, but you'll get the idea:
  769.  
  770. ---snip starts here---
  771.  
  772.                                Line 1
  773. -A B -C------------------ -J-------------
  774.  
  775. <---10---><---20---><---30---><---40---><---50---><---60---><---70---><--78-->
  776.  
  777. Port Number              Minimum Width: 2   Maximum Width: 4   Centered: Yes
  778. Width: 2   Text Bar: >P#<
  779. ForeGround: 4  BackGround: 6  Reversed: No   Underlined: No   BoldFaced: No
  780.  
  781.   *[A]*Port Number      [M] Last Call Date           [Y] Country Text
  782.    [B] Hide/Muffle Flag [N] Time Used Today          [Z] History Flag
  783.    [C] User Handle      [O] Primary Underscore       [1] Calls By This User
  784.    [D] User Real Name   [P] Secondary Underscore     [2] Balance Owing
  785.    [E] Logon Time       [Q] Total PFile Game Points  [3] Short Who Banner
  786.    [F] Logoff Time      [R] Access Group Number      [4] Glimpse File
  787.    [G] CPS Rate         [S] Access Group Name        [5] User ID Number
  788.    [H] Baud Rate        [T] Total Public Messages    [6] User SID Number
  789.    [I] City Text        [U] Total Uploaded Files     [7] Total File Credits
  790.    [J] Where Location   [V] Total Uploaded Bytes     [8] Total Byte Credits
  791.    [K] Gender Text      [W] Total Downloaded Files   [9] State Text
  792.    [L] Line Width       [X] Total Downloaded Bytes   [0] First Name
  793.  
  794. ---snip ends here---
  795.  
  796.     As you can see, I'm playing around with allowing you to pick from up to
  797. 36 different pieces of information. You can create WHO Layouts of up to 4
  798. lines each, where each line can contain ANY info you wish, in ANY order you
  799. wish, etc. I'm also playing around with the idea of attaching Access Group
  800. restrictions onto each data item, so that the data will only be shown to the
  801. user if their Access Group is high enough. If it's not, they'll just be shown
  802. some dead space in place of the info, or maybe I'll mask out the info. Not
  803. sure yet. I'm also playing around with the idea of creating custom TERMINAL
  804. versions for each file, so you can have ASCII, ANSI, and IBM-ANSI versions
  805. of the WHO files too.
  806.  
  807.     It's still in the planning stages right now, so if you have anything to
  808. ADD to these initial ideas, PLEASE forward them directly to me for inclusion
  809. into the next version!
  810.                                                                    - Dotoran
  811. ============================================================================
  812.                         Frontiers BBS (716)/823-9892!
  813. ============================================================================
  814.